home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / os2 / initor23.zip / initor.HLP (.txt) < prev    next >
OS/2 Help File  |  1997-06-17  |  39KB  |  1,049 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. ABOUT INITOR ΓòÉΓòÉΓòÉ
  3.  
  4. Initor enables you to edit OS2 "INI" files. You are able to add, delete, copy 
  5. and edit applications, keys and key data. Further more you are able to save and 
  6. read data from the current INI file to and from  another INI file(s). You can 
  7. also save applications, keys and key data to a ASCII HEX file such that you can 
  8. view it using an ASCII editor. 
  9.  
  10. DO NOT USE THIS PROGRAM IF YOU DONT KNOW WHAT YOU ARE DOING!!!! 
  11.  
  12. The author takes no responsibilty if INI files are damaged and no "safety keys" 
  13. are included into the application; therefore its very fast and efficient! 
  14.  
  15. This program was written because the LOTUS INI file editor has some problems. 
  16. The lotus ini editor cannot be sized to a different window size, it comes up 
  17. with this silly window at startup and does not remember the last directory were 
  18. a file was edited. So the basic structure of Real World Programmings INI file 
  19. editor was used and a few things and bugs were changed to make INITOR. 
  20.  
  21.  
  22. ΓòÉΓòÉΓòÉ <hidden> Note ΓòÉΓòÉΓòÉ
  23.  
  24. Note that this editor was written with speed in mind. I am looking after a few 
  25. systems (LanServer 4.0 etc) and needed a quick INI editor to change a few 
  26. settings to make a few applications "behave" a little better. 
  27.  
  28. I got frustrated with LOTUS INI editor because it doesn't remember the last 
  29. path, screen location and comes up with this box at startup telling you its 
  30. dangerous to change something in you INI files (dont we all know?????). So I 
  31. wrote this one and use it (and a few friends too) nearly every day. 
  32.  
  33. An I left out a few things to make this program faster to work with and not 
  34. have to press too many buttons. 
  35.  
  36.  
  37. ΓòÉΓòÉΓòÉ <hidden> Test ASCII file ΓòÉΓòÉΓòÉ
  38.  
  39. From version 2.3 on there is a test ASCII HEX file included. 
  40. This ASCII HEXFILE is called HEXTEST.ASC and you can see the syntax of a 
  41. correct ASCII file. You can try to load some data into an INI file or save 
  42. other applications to it. 
  43. Be sure to have a backup copy of the file if you want to get back to the 
  44. original. 
  45.  
  46.  
  47. ΓòÉΓòÉΓòÉ <hidden> Test INI file ΓòÉΓòÉΓòÉ
  48.  
  49. I have included a test INI file which you can load an try out a few things 
  50. before you want to change the "real" ones. It has a number of applications, 
  51. keys and key data in it. The file is taken from my LOTUS AmiPro. 
  52.  
  53. It is the "AMIUSER3.INI" files which contains all the setttings of a user. 
  54.  
  55. The first APPLICATION is the "AMIUSER" in that file. 
  56.  
  57. A KEY is for example the "BACKUPPATH" and the KEYDATA is "H:\AMIPRO\TMP" 
  58. (AmiPro's direcotry on my machine is on "H"). 
  59.  
  60. Try a few things here and you get the idea. 
  61.  
  62. You could test run INITOR'S INI file. Dont worry if you changed something 
  63. incorrectly. Simply re-make in that case using Make default ini file 
  64.  
  65.  
  66. ΓòÉΓòÉΓòÉ <hidden> History of INITOR ΓòÉΓòÉΓòÉ
  67.  
  68.      June 1996: INITOR 1.0 
  69.      June 1996: INITOR 1.1 
  70.         -  added very simple help menu (shows readme file). 
  71.         -  added abilty to edit and add BINARY data (hex data). 
  72.         -  fixed last path saved (path was cut off when longer the 20). 
  73.         -  fixed redraw when canceling add/edit dialog box. 
  74.         -  fixed some data appearing in key data window   when adding new key. 
  75.         -  fixed some data appearing in key data window   when adding new 
  76.            application. 
  77.      September 1996: INITOR 1.2 
  78.         -  added copy action for saving key data. 
  79.         -  added copy action for saving one application and all its keys. 
  80.         -  added entire file copy. 
  81.         -  fixed bug in the hex edit part, too small edit buffer (still only 
  82.            10K). 
  83.         -  fixed bug in memory allocation of data (leak?). 
  84.         -  fixed saving of changed data (quicker and more efficient). 
  85.         -  fixed bug of help file not found (using argument passed to main 
  86.            now). 
  87.         -  fixed a bug in my email address. 
  88.      October 1996: INITOR 1.3 
  89.         -  added reading in of other entire INI file into current INI file (ALL 
  90.            OF IT). 
  91.      October 1996: INITOR 1.4 
  92.         -  fixed "cancel" button in the edit application dialog box. 
  93.         -  added display of error message when incorrect INI file is used for 
  94.            reading/writing. 
  95.         -  changed the font in the hex box to courier (monospaced). 
  96.         -  added reading in of applications from other file into current INI 
  97.            file. 
  98.      October 1996: INITOR 1.5 
  99.         -  Icons can now be dropped onto INITOR. 
  100.         -  On the commandline you can call up INITOR with a filename specified. 
  101.         -  POPUP menus now working. 
  102.         -  Accelerate Keys now working. 
  103.         -  Partly fixed the memory usage. 
  104.         -  Rearranged the menus so there's now a FileMenu. 
  105.         -  Menus now include accelerator key names. 
  106.         -  Use TAB key now to jump between Application and Key window and 
  107.            scroll with key to the next item. 
  108.         -  There are now two paths to be saved to the initor ini file: 
  109.             + path name for display files. 
  110.             + path name for save/read files. 
  111.         -  INITOR has its OWN ini file now. Must/will be located in the same 
  112.            directory as the program itself. 
  113.         -  Fixed: Title specifies name of INI file now correct. 
  114.      October 1996: INITOR 1.6 
  115.         -  Fixed bug of being able to edit application even if "No Entries" 
  116.         -  Fixed wrong display of accelerator keys on the menus. (there I tell 
  117.            my students ALL the time to be careful using copy/paste functions 
  118.            and then I do it myself....) 
  119.         -  added filename to query menus to make sure that the CORRECT key gets 
  120.            deleted! 
  121.         -  added SPLIT/UNSPLIT menu to be able to edit *LARGE* keys (I mean 
  122.            *!LARGE!*) 
  123.      October 1996: INITOR 1.7 
  124.         -  Fixed bug from 1.5 and 1.6 where I forgot to switch of the dynamic 
  125.            inclusion of standard libraries. It was working with on my machine, 
  126.            coz the library was found in one of my path. 
  127.      December 1996 to January 1997: INITOR 2.0 
  128.         -  Fixed: at startup the system and user profile where loaded although 
  129.            only user profile displayed on title bar. 
  130.         -  Fixed: when unzipped first, MY screen location was in the initor.ini 
  131.            file which gave a few people some problems. I have not included my 
  132.            screen location. This will start INITOR the first time with some 
  133.            default location. 
  134.         -  Fixed: The Display area (HexBytes) did NOT display correctly bytes 
  135.            above 7F. I did not cast (c term) a value past to a long to 
  136.            (hex)string (sprintf) conversion function. It saw the upper byte a 
  137.            the negative flag. 
  138.         -  Fixed: When saving using the HEX WINDOW and adding a byte to the 
  139.            already existing value I had forgotten to recalculate the string 
  140.            length when passing it back to the window string function (once 
  141.            again rather stupid, indeed). 
  142.         -  Fixed (not my fault): When the ASCII string in the was less then 7 
  143.            bytes long it was NOT displayed on the ASCII display of the key 
  144.            display area. I have no idea, why this is the case. I calculated it 
  145.            properly but could not see the reason, so I made it constant and it 
  146.            works. This does not influence the performance of the editor but 
  147.            does get to my nerves since it is an ugly "help" and doesnt suit my 
  148.            philosophy of making things (nearly) perfect. 
  149.         -  Fixed: The vertical scroll bar now scrolls page wise, too. 
  150.         -  Fixed: When moving through the keys one at a time, and one of the 
  151.            keys would contain no data, the previous value was displayed intead 
  152.            of an empty data window. 
  153.         -  added context sensitive help and proper help menu, hence the new 
  154.            major number of INITOR. 
  155.         -  added copy option to copy an application or key to the current INI 
  156.            file but with a new name. 
  157.         -  changed: the screen location is now saved upon exit of the program. 
  158.            This was suggested by a number of users. 
  159.         -  added some settings into the initor.ini file. This stops 
  160.            confimations to pop up or to stop INITOR to save its screen location 
  161.            upon exit. 
  162.      April 1997: INITOR 2.1 
  163.         -  The compile and design platform of INITOR has been for a while 
  164.            Merlin. The compiler used up to February 1997 was Borland's C++. Now 
  165.            the compiler has changed to: Visual Age C++ for OS/2 by IBM. 
  166.         -  added feature to save applications, keys and key data to an ASCII 
  167.            HEX file to be able to read the data using a normal ASCII editor and 
  168.            to compare different ASCII file with each other. 
  169.         -  changed some of the memory allocation calls, should use less memory 
  170.            from now on! 
  171.      April 1997: INITOR 2.2 
  172.         -  I forgot to include the static link option in my compiler setup 
  173.            which led to problems that people did not have the libraries 
  174.            available. I appologize for this one, and it wasn't the first time 
  175.            it had happened. (See above). 
  176.      June 1997: INITOR 2.3 
  177.         -  Fixed: Borlands C++ compiler used to take a few errors not a 
  178.            seriously as the Visual Age C++ compiler of IBM. Furthermore seems 
  179.            that Borlandc C++ compiler "ovelooked" a few problems in my code 
  180.            leading to the problem that buttons did not get "switched back on". 
  181.            This was the case in the EDIT, COPY and ADD application boxes. I 
  182.            have to say I am very sorry and very embarrased about this. 
  183.         -  Fixed: Sometimes (on a few machines) when reading Applications from 
  184.            another file and reading this via list selection into the current 
  185.            file, the list crashed. This was due to the forgiveness of Borlandc 
  186.            C++ compiler. I could reproduce the error with what usrers told me 
  187.            and fixed this. 
  188.         -  Fixed: Again when I coded it with Borlands compiler the syntax used 
  189.            in making dialog boxes wasnt followed quite correctly. Using Visual 
  190.            Age C++ it simply did not see the coding. Following the PM-reference 
  191.            manual I fixed the font in the HEX BOX and it is now mono-spaced! 
  192.         -  ADDED: saving and reading to and from ASCII HEX files is now 
  193.            possible. I use this feature now (quite heavily actually) myself. Be 
  194.            careful when saving large INI files to ASCII. Each char in the INI 
  195.            file uses up 4 times more in the ASCII file. Including all the 
  196.            spaces, formatting etc a 700KB INI file blows up to 4MB!. It is 
  197.            quite useful when saving an application or a few applications! 
  198.  
  199.  
  200. ΓòÉΓòÉΓòÉ <hidden> Acknowledgements ΓòÉΓòÉΓòÉ
  201.  
  202. Below I would like to thank some people for bug reports, suggestions and ideas. 
  203.  
  204.      IBM for their C and C++ platform "Visual Age C++ for OS/2". I have seen a 
  205.       number of compilers in my time, but this beats everything! 
  206.      Blain, Delimon, and English for their excellent book "Real World 
  207.       Programming for OS/2 (1993)" from which some parts of this programs 
  208.       source code was taken. 
  209.      Jim  Gawn for his input of not fully setup vertical scroll bars of data 
  210.       window. I simply did not include code for it. 
  211.      Erwin Hogeweg for his input for large keys, this let to the split key 
  212.       menus. This was due to the limitation of a listbox being not able to show 
  213.       large data sizes. 
  214.      Raman Samanya for the idea of mouse button pop up menus, accelerator keys 
  215.       and switching off confirmation. 
  216.      Kevin Yank and Andreas Schlemmer for his idea passing the filename to be 
  217.       opened as a commandline option and hence being able to drop and 
  218.       associate. 
  219.      Tomi Soini for pointing out that the FILE_ID.DIZ file was missing in the 
  220.       zip file. 
  221.      Pat Shanahan for pointing out that there was a missing library when 
  222.       running INITOR 1.6! I switch off a lot of things during design to make 
  223.       compilation faster and I forgot to reset this when I put it onto the net 
  224.       (dynaimc versus static linking). 
  225.      Thomas Ho for reporting that the incorrect files where loaded upon 
  226.       startup (system ini and user ini where loaded). 
  227.      Traugot Ziegler, Reinhart Gruhn, Don Woodall, Mike Ryan for pointing out 
  228.       that the program ran off the screen upon startup. I had included into 
  229.       "initor.ini" my screen configuration which runs on 1024x768. People using 
  230.       lower screen resolutions ran into problems. 
  231.      Andre Nancoz for pointing out some errors in saving using the hex window. 
  232.       This was only the case when a key was increased by a byte and not saved 
  233.       before. He pointed out, too, that some keys DO NOT have "0" as an ending. 
  234.       This did not damage keys but just increased keys by one byte ending it 
  235.       with a "0". (Well when testing it you save things lots of times.....). 
  236.      Andre Nancoz for pointing out that in case a key had 0 data bytes the 
  237.       previous key was displayed. 
  238.      A number of people pointed out I had forgotten to make the libraries 
  239.       static and not include them dynamically (missing _doscalls lib). 
  240.      A number of people had pointed out that the OK button did not get 
  241.       reselected after data was added thus making it impossbile to save. 
  242.  
  243.  
  244. ΓòÉΓòÉΓòÉ <hidden> Enhancements for the future ΓòÉΓòÉΓòÉ
  245.  
  246.      Now that I have Visual Age C++ from IBM and the MultiLine listboxes with 
  247.       sizes greater the 64K are properly implemented I will redesign the 
  248.       editing part and make it part of the bottom window of the main canvas 
  249.       with an option of saving or not saving (I always wanted to do this!!!!). 
  250.      Add the ability to be asked when saving to an INI file and the data 
  251.       exists if the data should be overwritten and maybe give the possibilty of 
  252.       renaming the current key/application. 
  253.      Open two windows of INITOR and copy/paste between editors to get/save 
  254.       keys??? 
  255.      Some person suggested, to include a function like INIMAINT CTRL-F10 to 
  256.       clean up some junk. I have to figure out how to do this. Maybe somebody 
  257.       can give me a hand or hints??? 
  258.  
  259.  Other ideas anyone???? Suggestions. 
  260.  
  261.  Send suggestions and ideas to the author. Find the address in the about menu. 
  262.  
  263.  
  264. ΓòÉΓòÉΓòÉ <hidden> Compatibility of INITOR ΓòÉΓòÉΓòÉ
  265.  
  266. It has run on a number of systems with different types of WARP installed. This 
  267. program is designed and compiled from April 1997 onwards using IBM's Visual Age 
  268. C++ for OS/2. 
  269.  
  270. I (and a friend of mine) use this program for system administration purposes. 
  271. We looking after systems with different configurations and flavour of OS/2: 
  272.  
  273.      Warp plain 
  274.      Warp fixpak5 
  275.      Warp fixpak10 
  276.      Warp fixpak17 
  277.      Warp fixpak26 
  278.      Warp Server 4.0 
  279.      Merlin (design and compilation platform of INITOR) with and without 
  280.       fixpak 1. 
  281.  
  282.  
  283. ΓòÉΓòÉΓòÉ <hidden> Bugs of the program ΓòÉΓòÉΓòÉ
  284.  
  285. I tested this thouroughly and it worked fine with me and one other person, but 
  286. as you can see in the history and the acknowledgements, a number bugs came up 
  287. anyway. These bugs were related to program performance and not to data loss, 
  288. though! 
  289.  
  290. NOTE! 
  291. One user reported data loss when deleting a number of different applications at 
  292. the same time. I have tried and tried following his instructions but I cant 
  293. "replay" it. 
  294.  
  295. PLEASE! 
  296. Report bugs to the author! 
  297.  
  298.  I really would like to hear from you if you found any, so I can enhance the 
  299. program. I believe in (some) free stuff. 
  300.  
  301.  
  302. ΓòÉΓòÉΓòÉ <hidden> Contact the Author ΓòÉΓòÉΓòÉ
  303.  
  304. Jobst Schmalenbach 
  305. 19 York Street 
  306. Caulfield South, Vic, 3162 
  307. Australia 
  308.  
  309. Home phone: 61 3 9523 7348 
  310. Work phone: 61 3 9905 5705 
  311.  
  312. Email: jobst@senna.eng.monash.edu.au 
  313.  
  314.  
  315. ΓòÉΓòÉΓòÉ 2. Help Menu ΓòÉΓòÉΓòÉ
  316.  
  317. Use the choices on the Help pull-down to display: 
  318.  
  319.  Help index 
  320.        Displays the index of help menu. 
  321.  
  322.  General Help 
  323.        Displays some information about INITOR program. 
  324.  
  325.  Keys Help 
  326.        Displays a list of keys usage. 
  327.  
  328.  Using Help 
  329.        Provides detailed information on the kinds of help available and how to 
  330.        use help. 
  331.  
  332.  Product Information 
  333.        The dialog displays information about the address of the author and 
  334.        version number of the product. 
  335.  
  336.  
  337. ΓòÉΓòÉΓòÉ 3. Using Help ΓòÉΓòÉΓòÉ
  338.  
  339. Displays some general help information about INITOR program. This includes 
  340. basic operation and hints. 
  341.  
  342.  
  343. ΓòÉΓòÉΓòÉ 4. Using Help ΓòÉΓòÉΓòÉ
  344.  
  345. Use this choice to obtain information on how to use the Help facility. 
  346.  
  347.  
  348. ΓòÉΓòÉΓòÉ 5. Accelerator Keys ΓòÉΓòÉΓòÉ
  349.  
  350. Use this choice to see a list of keys and a description of the function of the 
  351. keys for the INITOR program. 
  352.  
  353. Accelerator keys simply are keys offering quick access to menus, which only 
  354. could be accessed using at least two clicks with the mouse. For example to get 
  355. to the "Copy Key" function, you need to click on "Copy" and then on "Copy Key". 
  356. Using the keyboard you can simply press "Shift-c". 
  357.  
  358. Press here to see more keys. 
  359.  
  360.  
  361. ΓòÉΓòÉΓòÉ 5.1. Key Assigments ΓòÉΓòÉΓòÉ
  362.  
  363. ACCELERATOR KEYS 
  364.  
  365. The list of keys is arranged in groups. 
  366.  
  367. HELP KEYS 
  368.  
  369.  F1 
  370.       Help Index Window 
  371.  
  372.  SHIFT F1 
  373.       Keys Help Window 
  374.  
  375.  Esc 
  376.       Previous Help Panel, or End help if only one panel 
  377.  
  378.  Alt 
  379.       Switch IN/OUT action bar 
  380.  
  381.  Alt+F4 
  382.       End help or End program 
  383.  
  384.  SYSTEM KEYS 
  385.  
  386.  Alt+Esc 
  387.       Switch to the next program, including full-screen programs 
  388.  
  389.  Ctrl+Esc 
  390.       Switch to the Task List 
  391.  
  392.  WINDOW KEYS 
  393.  
  394.  Underlined letter 
  395.       Move among the choices on the action bar and pull-downs submenu or 
  396.       execute the function chosen 
  397.  
  398.  INITOR SPECIFIC KEYS 
  399.  
  400.  SHIFT+A 
  401.       Display the Product Information (About) Dialog Box. 
  402.  
  403.  SHIFT+U 
  404.       Load the USER PROFILE into the editor. 
  405.  
  406.  SHIFT+S 
  407.       Load the SYSTEM PROFILE into the editor. 
  408.  
  409.  SHIFT+P 
  410.       Load the USER PROFILE and SYSTEM PROFILE into the editor. 
  411.  
  412.  SHIFT+O 
  413.       Load the a user specified INI file into the editor. A dialog box will pop 
  414.       up and a filename can be specified. 
  415.  
  416.  SHIFT+R 
  417.       Refresh current INI file (reload). 
  418.  
  419.  ALT+X 
  420.       Quit program. 
  421.  
  422.  BACKSPACE 
  423.       Split current key into chunks of 8000 bytes, such that it can be used for 
  424.       dialog boxes. 
  425.  
  426.  SHIFT+BACKSPACE 
  427.       UN-split current set of keys to make it one key again. 
  428.  
  429.  SPACE 
  430.       Edit current application using the ASCII editor. 
  431.  
  432.  SHIFT+SPACE 
  433.       Edit current application using the HEX editor. 
  434.  
  435.  INSERT 
  436.       Add a new application to current INI file. 
  437.  
  438.  SHIFT+INSERT 
  439.       Add a new KEY to current application. 
  440.  
  441.  DELETE 
  442.       Delete current APPLICATION. 
  443.  
  444.  SHIFT+DELETE 
  445.       Delete current KEY. 
  446.  
  447.  SHIFT+C 
  448.       Copy current application to a new application with a different name. 
  449.  
  450.  CONTORL+SHIFT+C 
  451.       Copy current key to a new key with a different name. 
  452.  
  453.  TAB 
  454.       Switch between windows. This selects either KEY or APPLICATION window 
  455.       such that it can be scrolled using keys. 
  456.  
  457.  
  458. ΓòÉΓòÉΓòÉ <hidden> Moving around ΓòÉΓòÉΓòÉ
  459.  
  460. You simply click on an application to go to another application in the 
  461. "Application Name" Window using scroll bars as well. 
  462.  
  463. You can use the TAB key to switch between the applicatio or key windows and 
  464. scroll using the cursor keys. 
  465.  
  466. All key names of that application will be displayed in the "Key Name" window. 
  467.  
  468. The data of the first key will be displayed in HEX and ASCII. If you need 
  469. another key, click on another key and the new data will be displayed with 
  470. offset and the number of bytes in HEX and ASCII. 
  471.  
  472.  
  473. ΓòÉΓòÉΓòÉ 6. File Menu Help ΓòÉΓòÉΓòÉ
  474.  
  475. If you want to change to another INI file click on "File" (ALT-f). 
  476.  
  477.      You can choose: 
  478.         -  USER INI FILE (os2.ini) 
  479.         -  SYSTEM INI FILE (os2sys.ini) 
  480.         -  USER AND SYSTEM FILE (above together) 
  481.         -  Other INI files (eg. AmiPro's INI FILES) 
  482.  
  483.         -  Refresh will update the display, thus re-read the current INI file. 
  484.         -  Exit will close INITOR. 
  485.  
  486.  
  487. ΓòÉΓòÉΓòÉ <hidden> Open User Profile ΓòÉΓòÉΓòÉ
  488.  
  489. If you click on this menu item, the user profile (OS2.INI) will be loaded into 
  490. the editor. 
  491.  
  492.  
  493. ΓòÉΓòÉΓòÉ 6.1. Open System Profile ΓòÉΓòÉΓòÉ
  494.  
  495. If you click on this menu item, the system profile (OS2SYS.INI) will be loaded 
  496. into the editor. 
  497.  
  498.  
  499. ΓòÉΓòÉΓòÉ 6.2. Open User and System Profile ΓòÉΓòÉΓòÉ
  500.  
  501. If you click on this menu item, the system profile (OS2SYS.INI) and the user 
  502. profile (OS2.INI) will both be loaded into the editor. 
  503.  
  504.  
  505. ΓòÉΓòÉΓòÉ 6.3. Refresh ΓòÉΓòÉΓòÉ
  506.  
  507. Refresh will update the display, thus re-read the current INI file. 
  508.  
  509.  
  510. ΓòÉΓòÉΓòÉ 6.4. Exit ΓòÉΓòÉΓòÉ
  511.  
  512. Exit will close INITOR. 
  513.  
  514. This will also save the current screen location into the INITOR.INI file. You 
  515. an change the default saving of the window position using the explanation under 
  516. the meu Initor's own INI file. 
  517.  
  518.  
  519. ΓòÉΓòÉΓòÉ 6.5. Open Other Profile ΓòÉΓòÉΓòÉ
  520.  
  521. This option will allow you to open a particular INI file. 
  522.  
  523. This can be ANY INI file as long as it conforms to the INI file data standards. 
  524.  
  525. Example INI files would be: AMIPRO.INI, AMIUSER.INI, TCPOS2.INI and even 
  526. INITOR's "initor.ini". 
  527.  
  528. Once you clicked on this item a file dialog box will pop up and you can specify 
  529. (or find) the INI file you like to edit. 
  530.  
  531. The default "open" directory can be changed using Save Display Path. 
  532.  
  533.  
  534. ΓòÉΓòÉΓòÉ 6.6. Make default ini file ΓòÉΓòÉΓòÉ
  535.  
  536. A new "initor.ini" file for INITOR is made. When this menu option is chosen the 
  537. following new applications and keys are made which are used during operation of 
  538. INITOR! 
  539.  
  540.      Basic Configuration 
  541.         -  Display Path 
  542.         -  SaveRead Path 
  543.         -  SaveScreenPositionOnClose 
  544.         -  ScreenPosition 
  545.      Confirmations 
  546.         -  ConfirmDelete 
  547.         -  ConfirmSplit 
  548.  
  549.  See the help menu Initor's own INI file for further explanation. 
  550.  
  551.  
  552. ΓòÉΓòÉΓòÉ 7. Initor's own INI file ΓòÉΓòÉΓòÉ
  553.  
  554. INITOR uses its own INI file "initor.ini" to find some configuration values at 
  555. run time. Each one of the entries in the INITOR's ini file is explained below 
  556. with application name, key name and possible values and how the values 
  557. influence the perfomrmance of initor. 
  558.  
  559. Rather then adding a menu to INITOR the user can simply change the values (and 
  560. hence the behaviour) by editing using INITOR the file initor.ini in INITOR's 
  561. directory. 
  562.  
  563. If something went wrong the user can simly re-make a new initor.ini file using 
  564. default configurations. See hereof Make default ini file. 
  565.  
  566. The application name is first, the key name is named second. 
  567.  
  568.      "Basic Configuration" - "Display Path" 
  569.       This value is a string constant and contains the path of the last opened 
  570.       "other" ini file. If changed the dialog box of open other will have the 
  571.       new path entry. 
  572.       See Menu: Save -> DisplayPath. 
  573.  
  574.      "Basic Configuration" - "SaveRead Path" 
  575.       This value is a string constant and contains the value of the last saved 
  576.       to directory, that is using the menu Save. 
  577.       See Menu: Save -> ReadPath. 
  578.  
  579.      "Basic Configuration" - "SaveScreenPositionOnClose" 
  580.       Ths value is a string constant and can only have the values "ON" or 
  581.       "OFF". When set to "ON" the current screen location of the INITOR is 
  582.       saved to the initor.ini file. When set to "OFF" screen location saving 
  583.       can only be done using the menu "save screen location". 
  584.       See Menu: Save -> SaveScreenLocation. 
  585.  
  586.      "Basic Configuration" - "ScreenPosition" 
  587.       This value are for unsigned long integer and make up the dimensions of 
  588.       the window upon startup and contains the location when screen poisition 
  589.       is saved. This is also set to the current location when a new ini  file 
  590.       is produced. 
  591.       See Menu: Save -> SaveScreenLocation. 
  592.  
  593.      "Confirmations" - "ConfirmDelete" 
  594.       This is a string and can either be set to "ON" or "OFF". If set to "ON" a 
  595.       confirmation box will appear before deletion of application and keys. If 
  596.       set to "OFF" this application box will not appear and the applications 
  597.       and keys are deleted straight away! 
  598.  
  599.      "Confirmations" - "ConfirmSplit" 
  600.       This is a string and can either be set to "ON" or "OFF". If set to "ON" 
  601.       it will ask for confirmation to split a key (unsplit a key). If set to 
  602.       "OFF" it will not ask and split/unsplit the key straight away!. 
  603.  
  604.  
  605. ΓòÉΓòÉΓòÉ 8. Edit Items Menu Help ΓòÉΓòÉΓòÉ
  606.  
  607. To change the data of an  application use "Edit Application" (alt-e). 
  608.  
  609. A Dialog box will appear to either edit an application or key in ASCII  or HEX. 
  610.  
  611. You cannot change the application name, that is set read only but you can 
  612. change the key name and the data. If you need to change an application to a 
  613. different name use Copy Items providing a way to change the name of an 
  614. application. 
  615.  
  616.  
  617. ΓòÉΓòÉΓòÉ 8.1. Edit Application (ASCII) ΓòÉΓòÉΓòÉ
  618.  
  619. This dialog box has the application in the first row, the key name in the 
  620. second and the data in the listbox underneath. 
  621.  
  622. This dialog box is for ASCII strings with values above 32 and below 127 
  623. (ASCII). If key data is shown with values below 32 you can click on "HEX" 
  624. button and another dialog box appears to be able to change binary data. See 
  625. Edit Application (Hex) 
  626.  
  627. If you want to edit keys larger than 10500 bytes you might consider reading the 
  628. SPLIT and UNSPLIT  found in other sections of this manual. 
  629.  
  630.  
  631. ΓòÉΓòÉΓòÉ 8.2. Edit Application (Hex) ΓòÉΓòÉΓòÉ
  632.  
  633. This dialog box is for ASCII strings with values below 32 and above 127. 
  634.  
  635. If you clicked on the HEX button in the "ADD-EDIT" dialog box above a dialog 
  636. box appears to edit hex (binary) data. 
  637.  
  638. Just edit data as required keeping a space between each BYTE and use HEX and 
  639. BINARY numbers to enter data into the window. 
  640.  
  641. You must keep a space between each byte or else your data will not be accepted. 
  642. The box will stay until the data is accepted or you press CANCEL. 
  643.  
  644. You must end the data in the hex window with a "00" and a space. The "00" is 
  645. part of the key data in the INI files and the space is the programs way to 
  646. determine a byte separated from another byte. 
  647.  
  648. I dont think this is a major problem although it might seem a little awkward in 
  649. the first place. 
  650.  
  651. If you want to edit keys larger than 10500 bytes you might consider reading the 
  652. SPLIT and UNSPLIT  found in other sections of this manual. 
  653.  
  654.  
  655. ΓòÉΓòÉΓòÉ 9. Add Items Menu Help ΓòÉΓòÉΓòÉ
  656.  
  657. If you need to add a new application or add a new key to an existing 
  658. application choose "Add Items" (ALT-A). 
  659.  
  660. You have then two options to either add a new application or a new key. Both of 
  661. the options require to add some data as well. 
  662.  
  663.  
  664. ΓòÉΓòÉΓòÉ 9.1. Add New Application ΓòÉΓòÉΓòÉ
  665.  
  666. This option adds a new application to the INI file. An application is for 
  667. example "AmiPro" or "Netscape" found in the user (OS2.INI) file. If you add a 
  668. new application it will be sorted alphabetically (not in the INI file). You 
  669. must give a new key and data as well, otherwise the application will not be 
  670. accepted. 
  671.  
  672.  
  673. ΓòÉΓòÉΓòÉ 9.2. Add New Key ΓòÉΓòÉΓòÉ
  674.  
  675. This option adds a new KEY to the current application pointed at. A new key 
  676. would be for example "TMPPATH" with data (maybe) "H:\tmp" for and application 
  677. "BackupDir". 
  678.  
  679.  
  680. ΓòÉΓòÉΓòÉ 10. Delete Items Menu Help ΓòÉΓòÉΓòÉ
  681.  
  682. If you need to delete a key or application click on "Delete Items" (ALT-d). 
  683.  
  684. This will delete either the current application or current key depending on 
  685. which of the menus Delete Application  or Delete Key  you have chosen. 
  686.  
  687. You are asked for confirmation to delete the key or application. The 
  688. application or key name is displayed on the query menu, so you know which key 
  689. it is. 
  690.  
  691. You can switch off confirmation. See hereof the help item Initor's own INI 
  692. file. 
  693.  
  694.  
  695. ΓòÉΓòÉΓòÉ 10.1. Delete Application ΓòÉΓòÉΓòÉ
  696.  
  697. This will delete the applcation pointed at with all keys belonging to THAT 
  698. application and the data belonging to the keys. An application example: 
  699. "AMIUSER" in the provided test.ini! 
  700.  
  701.  
  702. ΓòÉΓòÉΓòÉ 10.2. Delete Key ΓòÉΓòÉΓòÉ
  703.  
  704. This will delete the key and the data. 
  705. A key example of above application "BackUpPath" 
  706.   Data (maybe) for the above key "H:\tmp" 
  707.  
  708. If the key was the only  key to the application, the application is deleted as 
  709. well. 
  710.  
  711.  
  712. ΓòÉΓòÉΓòÉ 11. Copy Items Menu Help ΓòÉΓòÉΓòÉ
  713.  
  714. This option allows you to copy an application or a key with a different name 
  715. into the current INI file. You could use this option for example with IBM's 
  716. "TCPOS2.INI" which contains information for the dialer. You can copy an 
  717. existing dialer setting (application) to another name an change a few settings. 
  718. This will save a fair amount of time clicking through the setup. 
  719.  
  720. This option is also useful to save an application or key before you want to 
  721. make some changes. In case something went wrong you can simply copy it back. 
  722.  
  723. A dialog box will pop up and ask you for the new name. Note that you cannot 
  724. change the "from" value, it is read only. 
  725.  
  726. You can either copy a complete application or a single key . 
  727.  
  728.  
  729. ΓòÉΓòÉΓòÉ 11.1. Copy Application ΓòÉΓòÉΓòÉ
  730.  
  731. This option copies an entire application with all its keys and data to a new 
  732. application with a different name but same content. 
  733.  
  734.  
  735. ΓòÉΓòÉΓòÉ 11.2. Copy Key ΓòÉΓòÉΓòÉ
  736.  
  737. This option copies a key and its data to the same application but with a 
  738. different key name. The data will be identical. 
  739.  
  740.  
  741. ΓòÉΓòÉΓòÉ 12. HEX file (ASCII) format ΓòÉΓòÉΓòÉ
  742.  
  743. Below you can find the format of the ASCII HEX FILE so you can write you own to 
  744. import it into an INI file loaded. An example ASCII HEX file is included in 
  745. this distribution of INITOR. 
  746.  
  747. The first item specifies the application and must be of the form: 
  748.  
  749.    Application: Application Name up to 255 chars with spaces. 
  750.  
  751. The Application specifier and the name must be separated by at least on 
  752. character. The rest of the line specifies the name of the application 
  753. (including spaces unitl end of line encountered. 
  754.  
  755. The next item specifies the keyname of the application. It must be of the form: 
  756.  
  757.    Key: Key name up to 255 chars including spaces. 
  758.  
  759. The keyname specifier and the keyname must be separated by at least one space. 
  760. The rest of the line specifies the keyname.(including spaces unitl end of line 
  761. encountered. 
  762.  
  763. The next item specifies the size of the key and it must be of the form: 
  764.  
  765.    Size: number 
  766.  
  767. The number and the Size: identifier must be separated by a space. 
  768.  
  769. Note:  Particular care must be taken specifying the size. 
  770. There need to be 1 item for each XX, thus: XX XX XX XX XX would be 5 in size. 
  771. The number MUST be specified in HEX! 
  772.  
  773. Note:  The numbers must exactly match the number of items to be read otherwise 
  774. and error will be shown! 
  775.  
  776. The next item is the key data. Each line is preceded by its position in the key 
  777. data, eg: 
  778.  
  779.    000000: 6A 7B 17 10 00 00 44 00 E0 00 1C 03 00 02 01 00 >j{....D.╤Ç.......< 
  780.    000010: 00 00 44 00 E0 00 1C 03 00 02 01 00 00 00 FF FF >..D.╤Ç.........┬á┬á< 
  781.  
  782. This is ONLY done such that the reader can find out at which position a 
  783. character is in the key, especially if it is a longer key. When specifying this 
  784. in a file to be read in, it would be sufficient to specify: 
  785.  
  786.    XXXXXXX 6A 7B 17 10 00 00 44 00 E0 00 1C 03 00 02 01 00 >j{....D.╤Ç.......< 
  787.    XXXXXXX 00 00 44 00 E0 00 1C 03 00 02 01 00 00 00 FF FF >..D.╤Ç.........┬á┬á< 
  788.  
  789. as it would still read in the key data correcty since it is read in 
  790. sequencially and not by the values at the beginning of the line! 
  791.  
  792. If you make an error INITOR will specify the line number of the error and an 
  793. expected character. 
  794.  
  795. Note:  If you need to know the setup of an ASCII HEX file, just save an exapmle 
  796. ASCII HEX file and you know what is required. 
  797.  
  798.  
  799. ΓòÉΓòÉΓòÉ 13. Save Menu Help ΓòÉΓòÉΓòÉ
  800.  
  801. This menu will save data of INI files and configuration items from INITOR. 
  802.  
  803. Saving INI file data can be done using two types of saving actions: 
  804.  
  805.      Save data to other INI  file(s) 
  806.      Save data to ASCII HEX  file(s). 
  807.  
  808.  Using the following items: 
  809.  
  810.      Save Display Path 
  811.      Save Read Path 
  812.      Save Location 
  813.  
  814.  some of INITOR's own configuration items can be saved into its own INI file. 
  815.  
  816.  
  817. ΓòÉΓòÉΓòÉ 14. Save Data to other INI file ΓòÉΓòÉΓòÉ
  818.  
  819. If you want to save (or copy) an application or key to another file you may do 
  820. so by using the save menu (ALT-s). 
  821.  
  822. The following options available are: 
  823.  
  824.      Save Application to other (INI) File 
  825.       This option saves ALL KEYS of one (selected) APPLICATION to a new 
  826.       (specified) file. 
  827.      Save Key to other (INI) File 
  828.       This option saves ONE (selected) KEY of one (selected) APPLICATION to a 
  829.       new (specified) file. 
  830.      Save ALL to other (INI) File. 
  831.       This option saves all information of the current file to a new 
  832.       (specified) file. 
  833.  
  834.       Note:  If this file exists, it is replaced! I had to do this because the 
  835.       sizes of some files would grow incredibly! 
  836.  
  837.  After you clicked on one of the three you are asked (dialog box) to specify 
  838.  the file name. If you specify an existing file the information is simply added 
  839.  to the file. 
  840.  
  841.  The nature of INI data writing does not allow for appending. If the data you 
  842.  want to write to an INI file exists in that file it is simply replaced. No 
  843.  check (YET) is made. So you must make sure you do not overwrite the current 
  844.  application in the "save to" file. (You could simply open another copy of the 
  845.  INITOR.) 
  846.  
  847.  If the file already exists, but is NOT a proper INI file, an error message 
  848.  will be displayed and nothing will happen. 
  849.  
  850.  The currently selected item in either of the lists will be the item to be 
  851.  saved to a file selected in the file dialog box. 
  852.  
  853.  
  854. ΓòÉΓòÉΓòÉ 15. Save Data to ASCII HEX file ΓòÉΓòÉΓòÉ
  855.  
  856. If you want to save (or copy) an application or key to another file in ASCII 
  857. HEX format you may do so by using the save menu (ALT-s) and then selecting one 
  858. of the following options. The format of the ASCII file you can find the 
  859. explanation under HEX file (ASCII) format. 
  860. The ASCII file is human readable. Each application, key and key data is 
  861. specified in ASCII HEX charracters. Each key line is preceded by its distance 
  862. from the beginning of the key. 
  863.  
  864.      Save Application to ASCII HEX 
  865.       This option saves an entire application to a ASCII HEX file. 
  866.      Save Key to ASCII HEX file 
  867.       This option save only one key to a ASCII HEX file. The ASCII file is 
  868.       human readable. Each application, key and key data is specified in ASCII 
  869.       HEX charracters. Each key line is preceded by its distance from the 
  870.       beginning of the key for the entire length of the key. 
  871.      Save All to ASCII HEX file 
  872.       With this option you can save an entire INI file to a ASCII readable HEX 
  873.       file. Be careful using this options, the size of the ASCI file is about 4 
  874.       times bigger than the INI file. This is due to tha fact that one byte in 
  875.       the INI file uses up 3 chars in the ASCII file. The formatting of the 
  876.       document to make it more readable then increases the size by another 1 
  877.       byte. So taking a 700MB ini file can increase to a 3MB file as checked 
  878.       with my OS@.INI file! 
  879.  
  880.  If you use either of the above options you will be asked to specify a file. If 
  881.  this file exists, the new data is simply appended to that file. If the file 
  882.  does not exist, it is opened new. If the file is a binary data file, you will 
  883.  get an error message that you are not able to open this file. 
  884.  
  885.  
  886. ΓòÉΓòÉΓòÉ 16. Save configuration options of INITOR ΓòÉΓòÉΓòÉ
  887.  
  888. Some of initors options used during run time can be saved using the following 
  889. options: 
  890.  
  891.      Save Display Path 
  892.       This option saves the path of the directory last read from, that is the 
  893.       directory of the last file opened using the option 
  894.  
  895.      Save Read Path 
  896.       This option saves the path of the directory last read saved to, that is 
  897.       the directory where ini files are written to. 
  898.  
  899.      Save Window Position 
  900.       This option save the current window location. This option is only of use 
  901.       if the save window upon exit is disabled. 
  902.  
  903.  
  904. ΓòÉΓòÉΓòÉ 17. Read Menu Help ΓòÉΓòÉΓòÉ
  905.  
  906. If you want to read data from a specified INI file into the current displayed 
  907. file simply click on (ALT-r): 
  908.  
  909. There are two choices to read data from another file into the current file: 
  910.  
  911.      Read INI file data into current file. 
  912.      Read ASCII HEX data into current file. 
  913.  
  914.  Once you clicked on one of the items, you are asked to specify a filename to 
  915.  read from. 
  916.  
  917.  If you specify a new file it is opened (for saving only). 
  918.  
  919.  If you specify an existing file it is checked and if it's not a proper INI 
  920.  file an error message will be displayed and nothing happens. 
  921.  
  922.  
  923. ΓòÉΓòÉΓòÉ 17.1. Read other INI data file ΓòÉΓòÉΓòÉ
  924.  
  925. This options allows you to read other INI file data into the current INI file. 
  926. There are two options available: 
  927.  
  928.      Read Application(s) from other file. 
  929.       This option allows you to read particular applications from another 
  930.       specified ini file into the current file. If you select this option, you 
  931.       need to specify a filename. If you selecet cancel the procedure is simly 
  932.       aborted. If you select OK the INI file is scanned for available 
  933.       applications which are displayed in a selection box. If the file fails to 
  934.       be an INI file a message will be displayed! You can select multiple 
  935.       applications, a double select will deselect. If you press OK the selectd 
  936.       applications are read into the current file. If the applications exist, 
  937.       they are overwritten. no check is made. If you need to read another 
  938.       appliations in with the same name you could rename the current 
  939.       application and then read in the new one. 
  940.  
  941.  
  942.      Read other INI file into current file. 
  943.       This option reads an entire INI file into the current file. If an 
  944.       application or key existed in the current file, no check is made. It is 
  945.       simply overwritten. If you select this option you have to specify a 
  946.       filename. If you select OK the file is checked whether it is an INI file. 
  947.       If it fails to be an INI file the process will be aborted. If it is OK 
  948.       the entire file is read into the current file. 
  949.  
  950.  
  951. ΓòÉΓòÉΓòÉ 17.2. Read ASCII HEX data ΓòÉΓòÉΓòÉ
  952.  
  953. This option allows you to read ASCII HEX DATA into the current INI file. There 
  954. are two options avaialble: 
  955.  
  956.      Read Application(s) from ASCII HEX file. 
  957.       This option allows you to read particular applications from an ASCII HEX 
  958.       file into the current file. If you select this option, you need to 
  959.       specify a filename. If you selecet cancel the procedure is simly aborted. 
  960.       If you select OK the INI file is scanned for available applications which 
  961.       are displayed in a selection box. If the file fails to be a ASCII hex 
  962.       file as specified under ASCII HEX file format an error message will be 
  963.       displayed! You can select multiple applications, a double select will 
  964.       deselect. If you press OK the selectd applications are read into the 
  965.       current file. If the applications exist, they are overwritten. no check 
  966.       is made. If you need to read another appliations in with the same name 
  967.       you could rename the current application and then read in the new one. 
  968.  
  969.  
  970.      Read all data from ASCII HEX file into current. 
  971.       This option reads ALL data from an ASCII HEX file into the current file. 
  972.       If you select this option, you need to specify a filename. If you selecet 
  973.       cancel the procedure is simply aborted. If you select OK the INI file is 
  974.       scanned for available applications and all the data is read into the 
  975.       current file. If data with the same name exists, it is replaced. If the 
  976.       file fails to be a ASCII hex file as specified under ASCII HEX file 
  977.       format an error message will be displayed! 
  978.  
  979.  
  980. ΓòÉΓòÉΓòÉ 18. Split Menu Help ΓòÉΓòÉΓòÉ
  981.  
  982. There is a limitation of how many bytes one can display in a dialog box. 
  983.  
  984. This is set to 32K. However, the HEX editor needs for each byte displayed 3 
  985. bytes to display the entity. (32K / 3) > 10500bytes. 
  986.  
  987.  Therefore if you need to edit a key which is larger than 10500 bytes you need 
  988. to split the key first. Using the SPLIT item from the MISC MENU will split the 
  989. key into 8000 byte chunks, with the last being the remainder of the key, hence 
  990. a 19396 byte long key is split into 2x8000 and 1x3396. 
  991.  
  992. You need to place the cursor on the key to be split. 
  993.  
  994. Using Unsplit will reverse the operation. 
  995.  
  996. Consider the unsplit key is called "testing" and its 19396 long. than the split 
  997. keys are called and sized: 
  998.  
  999.      testing_Initor SplitKey_1, 8000 
  1000.      testing_Initor SplitKey_2, 8000 
  1001.      testing_Initor SplitKey_3, 3396 
  1002.  
  1003.  Please leave the names until you unsplit them otherwise the program has no way 
  1004.  to find out which key is split and which of the keys belong together. When 
  1005.  unsplitting the cursor must be placed on the first key to unsplit. 
  1006.  
  1007.  
  1008. ΓòÉΓòÉΓòÉ 18.1. Split Key ΓòÉΓòÉΓòÉ
  1009.  
  1010. Using this option will split the key into 8000 byte chunks, with the last being 
  1011. the remainder of the key, hence a 19396 byte long key is split into 2x8000 and 
  1012. 1x3396. You need to place the cursor on the key to be split. 
  1013.  
  1014.  
  1015. ΓòÉΓòÉΓòÉ 18.2. Unsplit Key ΓòÉΓòÉΓòÉ
  1016.  
  1017. Using this option will put the keys together again. 
  1018.  
  1019. If you have edited one of the split keys this will produce a larger key or 
  1020. smaller key than the original one, depending on what you have done with the 
  1021. split keys. 
  1022.  
  1023.  
  1024. ΓòÉΓòÉΓòÉ 19. PopUp Menus ΓòÉΓòÉΓòÉ
  1025.  
  1026. POPUP menus are selected when the right mouse button is pressed in either of 
  1027. the windows (application or key). 
  1028.  
  1029. There are two POPUP menus availabe depending the window the cursor is on: 
  1030.  
  1031.      If the cursor is in the application window, the following popup is 
  1032.       displayed: 
  1033.         -  Add Application 
  1034.         -  Copy Application 
  1035.         -  Save Application 
  1036.         -  Delete Application 
  1037.         -  Edit Application ASCII 
  1038.         -  Edit Application HEX 
  1039.         -  Refresh 
  1040.      If the cursor is in the key window, the following popup is displayed: 
  1041.         -  Add Key 
  1042.         -  Copy Key 
  1043.         -  Save Key 
  1044.         -  Delete Key 
  1045.         -  Refresh 
  1046.  
  1047.  If you do not select anyone of the items, nothing will happen. You must hold 
  1048.  the right mouse as long as you want to select something. The popup menu 
  1049.  disappears as soon as the mouse button is released.